The code itself looks good. However, we are trying to make the Vitess code compliant to the Go styleguide, which includes having doccomments of the form

// Foo foos the bar.
func Foo(bar Bar) {
...
}

In my experience this actually helps when you are trying to figure out what the code is doing. Can you please reword your doccomments in this spirit?

I'm surprised to hear you say that. Quickly scanning the diff, the vast majority of important functions and structures (particularly the public functions) are quite well documented.

Did you have a specific example where something in here needed more explanation? About the only example I can think of is the Election() method which is explained by comments on the structure itself.